Main Configuration Files

WebWork has two main configuration files you need to be aware of: web.xml and xwork.xml. Here you will find out all the information you need for both WebWork's required and optional configuration files.

Below are all the files that you may need to be aware of. Some of this configuration files can be reloaded dynamically, making development much easier. See Reloading configuration for more information.

File Optional Location (relative to webapp) Purpose
web.xml no /WEB-INF/ Web deployment descriptor to include all necessary WebWork components
xwork.xml no /WEB-INF/classes/ Main configuration, contains result/view types, action mappings, interceptors, etc
webwork.properties yes /WEB-INF/classes/ WebWork properties
webwork-default.xml yes /WEB-INF/lib/webwork-x.x.jar Default configuration that should be included in xwork.xml
velocity.properties yes /WEB-INF/classes/ Override the default velocity configuration

Static Content

Common static content that is needed by webwork (JavaScript and CSS files, etc.) is server automatically by the FilterDispatcher filter. Any request starting with "/webwork/" denotes that static content is required, and then mapping the value after "/webwork/" to common packages in WebWork and, optionally in your class path.

By default, the following packages are searched:

  • com.opensymphony.webwork.static
  • template

Additional packages can be specified by providing a comma seperated list to the configuration parameter named "packages" (configured in web.xml for the FilterDispatcher filter). When specifying additional static content, you should be careful not to expose sensitive configuration information (i.e. database password).